SFCGENEditor Readme

このツールはSFC(SNES)のROMを読み込んで内容を参照、変更、保存することを目的としたものです。ROMの内容を一部ではなく全部そのままメモリ上に展開するのでそれなりにメモリ量を必要とします(ROMの最大容量はせいぜい8MBなので近年のPCのメモリ量ならそれほど問題にならないと思いますが)。情報を公開してくれた先人の努力に感謝します。ver0.7.0より、プラグイン方式を導入し、各ROM固有の部分(主にSFC版DQ3,6)をプラグインとして切り出し、共通部分から分離しています。これにより、汎用性、固有性の両方を確保したまま拡張することが可能になりました。このreadmeは本体部分の説明を対象にしています。

万人が使うものでもないと思うので、前提条件を満たしていない場合の動作やエラー発生時のハンドリングはあまり考えていません。現状このツールできることは以下のとおりです。

• 固定長データ部分の参照・変更・ROM中の場所移動
• 引数情報を加味したSR(サブルーチン、プログラム)部分のリアルタイム?逆アセンブル,SRからコールしている別のSRへの1クリックジャンプ,SRアドレスのリストの指すSRの逆アセンブル、SRの編集
• ROM中のデータ・SRの位置の一覧

本ツールを使用して発生したいかなる損害についても一切責任を負いません。またROMの入手方法についての質問も一切お答えできませんのでご了承ください。

本ソフトウェアはフリーウェアですが、ソースコードは公開しません。

2次配布は禁止とします。

.NET Framework ランタイム4.0以降を必要とします。Windows7,10(32bit, 64bit)で動作することを確認しています。Windows8.xでの動作は確認していません。ヘッダーなしのROMのみ対応しています。

適当なフォルダに解凍してSFCGENEditor.exeを起動してください(各種ROM用の専用プラグインはPluginsフォルダに置いて下さい。PluginBase.dllはPluginsフォルダに置く必要はありません。)。レジストリを使わないのでアンインストールはフォルダごと消すだけでOKです。

2-1)モジュール構成
SFCGENEditor.exe
PluginBase.dll
Be.Windows.Forms.HexBox_Custom.dll(バイナリエディタコントロール用)
Plugins(フォルダ)
プラグイン用DLL

起動時に起動したカレントディレクトリのSettingsフォルダの下にあるRomMap.xml、ShortCut.xmlとその中のPDTablesフォルダの中のファイル(PreDefineTable)を読みます。SFCGENEditor.iniもカレントディレクトリのファイルを読みます。

例)SFCGENEditor.exeをC:Program FilesSFCGENEditorフォルダに置き、ゲームX、ゲームYのSettingsファイルをC:GameX, C:GameYに配置した場合

C:Program FilesSFCGENEditor
-SFCGENEditor.exe (Aとする)
-PluinBase.dll(同B)
-他
-Plugins
-各種プラグインDLL(同C)

C:GameX
-Settings (同P)
-SFCGENEDitor.ini (同Q)
-SFCGENEDitor.exe(A)へのショートカット(同X)

C:GameY
-Settings (同R)
-SFCGENEDitor.ini (同S)
-SFCGENEDitor.exe(A)へのショートカット(同Y)

C:GameA、C:GameBにショートカットファイル(X),(Y)を置き、これらをダブルクリックすることで
Xをダブルクリックした場合はP,Qの設定を使って、Yをダブルクリックした場合はR,Sの設定を使ってプログラムが起動します。
プラグインはBもしくはCのものが使用されます。
また、「ROMを開く」を選択した場合に開くファイルダイアログの初期ディレクトリはショートカットのあるフォルダになるので、ここにROMイメージを入れておけばゲームごとの管理がそれぞれのフォルダで完結します。

RomMap.xmlには、対象のROM名、ROM上のアドレスのどこからどこまでが何を表すのか、その内訳はどうなっているのか、それを画面にどう表示するのかについての情報をXMLフォーマットで記述します。SFCGENEditor.exeは対象のROM名を持つプラグインをpluginsフォルダからロードします。読み込むROMファイル中に記述されているROM名はチェックしません。(パッチ製作者が変えている可能性があるため)

ShortCut.xmlには、ショートカットキーを割り当てる項目とそのキーの情報をXMLフォーマットで記述します。

PreDefineTableはデータを画面に表示する場合に人間に見やすい情報に変換するための情報を1テーブル1ファイルに記述します(変更の仕方については後述します)。ROMファイルを読み込んだときに、これらの情報に従ってROMを解析し、人間に見やすい情報に変換します。

読み込んだROMはバイナリ配列として内部で保持し、ツール上での変更をすぐさまこの配列に反映します。ROM保存時にはこのバイナリ配列をファイルにそのまま書き出すだけです。

※デフォルトのSettingsフォルダの中身ははSFC版DQ3用のものです。SettingsDQ3_ExtendedはSFC版DQ3職人用拡張パッチ(通称DQ3 extended ver1.44以降 http://dqnbinary.jp.land.to/cgi-bin/img/457.zip)用のファイルです。パッチ対応のROMを編集したい場合は、SettingsDQ3_ExtendedをSettingsにリネームして使用してください。

※SettingsDQ6はSFC版DQ6用のものです。DQ6のROMを読み込むときはSettingsにリネームしてからSFCGENEditorを起動してください。

起動するとペイン(枠?)を3つ持ったウィンドウが表示されるはずです。

左ペイン(①)がツリービューペイン、右上ペイン(②)をデータペイン、右下(③)を追加情報ペインと呼ぶことにします。

ROMの内容をツリー構造で表示します。ツリー構造自体はRomMap.xmlに記述されているので変更可能です。見たいデータをクリックするとデータペインに解析された状態でデータが表示されます。一番下に「ROM索引」というノードがあります。ここをクリックするとROM内の情報の所在がデータペインに表示されます。

RomMap.xmlの設定によって3種類の表示ができます。

基本はBNE2などと同様に解析結果を行列の状態で展開します。その場で値を変更できます。(セルのダブルクリックもしくはF2で編集開始です F2のほうが使いやすいはず。)
16進表記のデータは編集時に先頭に「$」(RomMap.xmlのHexPrefixで指定した文字列)が付いて、16進数で編集できるようになりました。
入力可能な範囲外の入力の場合は編集を受け付けないようになりました。(例:0-63の範囲なのに100を入力した場合など)固定長データに対し、レコード途中に複数行まとめて削除/挿入できるようにしました。処理したいレコードにフォーカスを移動し、右クリックでメニューを表示してください。

画像の格納方法はROMごとに異なるため、対応は各プラグインで行うことになります。

SR(SubRoutine,プログラムのこと)を逆アセンブルした結果を表示します。別のSRをコールしている行をダブルクリックするとそのSRにジャンプします。$FCの場合はジャンプしたいSRのインデックスを入力するウィンドウが出るので範囲内の数値を入れるとそのSRにジャンプします。Valsの列で編集します。半角スペースで区切って2文字ずつ16進で入力してください。変更を確定するとその場で再度逆アセンブリを行い、結果を表示します。SRの長さが増える場合は後ろに十分な空き領域が必要です。別のSRをコールしている行のValsの列をダブルクリックしてもコール先のSRに飛ばず、編集モードに移行するだけにしました。別のSRにジャンプしたい場合はValsの列以外をダブルクリックしてください。2文字ずつ区切らなくても入力できるようにしました。2文字以上で入力した場合はリトルエンディアン方式で変換されます。分岐命令、ジャンプ命令に対して、ジャンプ先のチェックをするようにしました。ジャンプ先がSR定義外の場合は背景色を薄青、ジャンプ先がSR内だが不正なアドレス(例:22 xx xx xxの2バイト目にジャンプなど)の場合は赤、それ以外の未検証の場合は薄灰で表示するようにし、ケアレスミスによるバグを見つけやすいようにしました。複数行(1行だけでも可・離れた複数行も可)を選択した状態で右クリックすると「選択行を削除」メニューが表示され、一度に複数行を削除できるようにしました。

データ表示モードの場合に現在選択している行のバイナリイメージを表示します。表示だけです。SR編集モードの場合はSR内で呼んでいる別のSRのリストを引数付きで表示します。

※画像中のメニューをクリックすると個別の説明にジャンプします。

※画像中のメニューをクリックすると個別の説明にジャンプします。

※画像中のメニューをクリックすると個別の説明にジャンプします。

※画像中のメニューをクリックすると個別の説明にジャンプします。

SFCGENEditorのプログラムバージョン、プラグインの情報・バージョンを表示します。

基本すべての定義はSFCGENEditor上で行えるようになったため、直接XMLを編集する必要はなくなったので省略

XML形式です。編集はメモ帳などで行ってください。(XML的に)正しく変更できているかどうかを確認するにはEdgeで開いてファイルの最後まで正しくパース(解釈)できていればOKです。XMLでそのまま使用できない文字(< ,>,&,’,”)に気をつけてください。
※記述例:

1ファイルに1テーブルをCSV形式で記述します。ファイル名の拡張子を除いた文字列がテーブル名になります。テーブル名はRomMap.xmlで定義している固定長データのテーブル名と同じものは使えません。フィールドは2つまでで、1つ目のフィールドは表示用のデータ(disp),2つめのフィールドは値(value) を意味するものとします。3つ目以降はあっても無視します。valueは省略可能ですが、省略するときは全行省略してください。省略時には先頭から 0,1,2….を自動で付番します。

設定例:省略しない場合

設定例:省略する場合

1テーブルの中でvalueを指定したりしなかったりした場合の動作の確認はしていません。全レコード指定する/しないで統一してください。

通常のiniファイル形式です。設定可能なキーは以下のとおり

「ROMを開く」「ROMを保存」で表示されるファイルオープンダイアログでフィルターされる拡張子を指定する。記述方法はプログラム中で指定するオープンファイルダイアログのフィルターとして設定する文字列と全く同じ。

|フィルター文字列|拡張子(複数指定可能)

が1セットとなる。フィルターを複数設定したい場合は並べて複数記述するだけ。
設定例:

「ROMを開く」で表示されるファイルオープンダイアログで表示される初期ディレクトリを指定する。指定がない場合はカレントディレクトリを使う。

ROM保存時にチェックサムを自動で調整する。

0:調整しない(デフォルト)
1:調整する
設定例:

プログラム起動時に保存された座標情報を元にウィンドウ座標をリストアする。記録するのはプログラム終了時のみ。Left(ウィンドウの左端のX座標),Top(ウィンドウの上端のY座標),Width(水平方向の幅),Height(垂直方向の高さ)を,(カンマ)区切りで記述する。例外として、最大化の場合は”Maximized”、最小化の場合は”Minimized”と記述する。
設定例:

プラグイン中のアイコンを使用しない。

0:使用しない
1:使用する(デフォルト)
設定例:

新規SR定義、既存SR変更ダイアログでSR後のm,xフラグを指定できるコンボボックスを表示する。SRコールした後m,xフラグが変化する一部ゲーム(グラディウスⅢ?)で使用する。

0:表示しない(デフォルト)
1:表示する
設定例:

起動時に使用するSettingsフォルダを選択するダイアログを表示するか

0:表示しない
1:表示する(デフォルト)
設定例:

• filename:ROMファイル名を引数で指定することでそのROMファイルを開いて解釈した状態で起動します。フルパスで指定しなかった場合はSFCGENEditorと同じパスにあるものとして扱います。相対パスでの指定も可能です。
  例:
  
  >SFCGENEditor dq3sfc.smc

  1	>SFCGENEditor  dq3sfc.smc

• /L: Lightモード プログラムの逆アセンブルを行いません。

• 65816命令表
• 6502/65816 opecodes
• SNES研究室
• SNES 4BPP file format(リンク切れ)
• SNES Kart(リンク切れ)